Aller au contenu principal

Faire défiler un élément d’interface ou la page actuelle (ui_element.scroll)

Cette fonction est disponible à partir des versions postérieures au 20260507

Déclaration​

etat, info_ou_erreur = ui_element.scroll(direction [, options ])
etat, info_ou_erreur = ui_element.scroll(selecteur_ou_element, direction [, options ])

Paramètres​

  • selecteur_ou_element
    paramètre facultatif de type table, pouvant être un sélecteur, un élément renvoyé par une requête ou une table de coordonnées { x = coord_x, y = coord_y }.
  • direction
    type texte, accepte "down", "up", "left", "right", "top" et "bottom".
  • options
    paramètre facultatif de type table. point, x et y permettent d’indiquer le point de détection ; steps permet d’indiquer le paramètre de pas.

Valeur renvoyée​

  • etat
    type booléen, vaut true en cas de réussite et nil en cas d’échec.
  • info_ou_erreur
    type table contenant les informations de l’action en cas de réussite, ou texte décrivant la cause de l’échec.

Description​

Sans sélecteur, tente par défaut de faire défiler la page actuelle. Avec un sélecteur, tente de faire défiler la zone défilable contenant l’élément cible. Pour garantir le défilement de plusieurs pages, il est recommandé d’appeler la fonction en boucle dans le script Lua et de vérifier soi-même les changements de page.

Exemple​

local ui_element = require("ui_element")

ui_element.scroll("down", {
point = { x = 200, y = 700 },
})

ui_element.scroll({
text_contains = "列表",
}, "up")